IDFPControl

# IDFPControl.ocx简介

## 1、属性相关介绍

### 1.1 rawBase64

      功能：指纹图像的原始数据，为Base64格式。
      类型：BSTR(字符串)，只读。

### 1.2 jpgBase64

      功能：指纹图像的jpg格式数据，为Base64格式。
      类型：BSTR(字符串)，只读。

### 1.3 featureBase64

      功能：指纹模板数据，为Base64格式。
      类型：BSTR(字符串)，只读。

### 1.4 rawWidth

      功能：指纹原始图像的宽度。
      类型：SHORT(短整型)，只读。

### 1.5 rawHeight

      功能：指纹原始图像的高度。
      类型：SHORT(短整型)，只读。

## 2、接口相关介绍

### 2.1 采集指纹图像

     接口名：BOOL GetFPImage()

     功能：获取指纹图像。
     参数：
        无
     返回值：
        成功返回：TRUE，失败返回：FALSE。
    备注
        调用成功后可获取属性[rawBase64/jpgBase64/rawWidth/rawHeight]

### 2.2 获取指纹数据

    接口名：BOOL GetFPData()

    功能：获取指纹数据。
     参数：
        无
    返回值：
        成功返回：TRUE，失败返回：FALSE。
    备注
        调用成功后可获取属性[rawBase64/jpgBase64/featureBase64/rawWidth/rawHeight]

### 2.3 指纹图像比对指纹模板

    接口名：short FPImageMatch(unsigned char * rawBase64,unsigned char * Feature)

    功能：比对指纹图像和指纹模板相似度
    参数：
        rawBase64
            原始图(见属性[rawBase64])
        rawBase64
            指纹模板(见属性[featureBase64]，或者从身份证读取的指纹模板)
    返回值：
        比对分数值：（范围为：0~100）。
    备注：
        超过55分(建议阈值)为比对成功，反之比对失败。

### 2.4 指纹模板比对指纹模板

    接口名：short FPFeatureMatch(unsigned char * verFeature,unsigned char * regFeature)

    功能：比对两个指纹模板相似度
    参数：
        verFeature
            比对指纹模板1(见属性[featureBase64]，或者从身份证读取的模板)
        regFeature
            比对指纹模板2(见属性[featureBase64]，或者从身份证读取的模板)
    返回值：
        比对分数值：（范围为：0~100）。
    备注：
        1、该接口不支持

### 2.5 打开设备

    接口名：BOOL OpenDevice()
    功能：打开设备
    参数：
        无
    返回值：
        成功返回：TRUE，失败返回：FALSE。

### 2.6 关闭设备

    接口名：BOOL CloseDevice()
    功能：关闭设备
    参数：
        无
    返回值：
        成功返回：TRUE，失败返回：FALSE。

### 2.7 开始采集

    接口名：BOOL StartCapture()
    功能：开始采集
    参数：
        无
    返回值：
        成功返回：TRUE，失败返回：FALSE。
    备注：
       当开始采集成功后，有指纹按压就会触发OnCaptureOk()事件

### 2.8 停止采集

    接口名：BOOL StopCapture()
    功能：设备
    参数：
        无
    返回值：
        成功返回：TRUE，失败返回：FALSE。
    备注：
       当停止采集成功后，有指纹按压时就不会触发OnCaptureOk()事件

## 3、事件相关介绍

    事件名：OnCaptureOk()
    功能：捕获指纹按压事件
    备注：
       当该事件捕获到后，就可以获取相关属性